Markdown-Dingus

Der Markdown-Dingus ist ein spezialisiertes Testwerkzeug, mit dem Sie nachvollziehen können, wie verschiedene Markdown-Prozessoren Ihren Inhalt behandeln. Er bietet eine dreigeteilte Oberfläche, in der Sie gleichzeitig Markdown bearbeiten, den erzeugten HTML-Quelltext ansehen und die gerenderte Vorschau sehen.

Der Dingus teilt sich einige Low-Level-Behandlungen mit Markeds Vorschau, etwa die besondere Behandlung abgegrenzter Codeblöcke. Er führt keine Eigenen Regeln (Conductor) aus. Er verwendet weitgehend die Standardeinstellungen und ignoriert Einstellungen wie „GitHub-Zeilenumbrüche“ und „GitHub-Kontrollkästchen“, sodass das Ergebnis von dem abweichen kann, was Sie in einer normalen Marked-Vorschau sehen.

Eigene Regeln gelten nicht

Der Dingus ist eine Prozessor-Sandbox: Ihr Markdown geht direkt an den integrierten Prozessor, den Sie wählen (MultiMarkdown, CommonMark (GFM), Discount oder Kramdown). Eigene Regeln laufen dort nie – keine Präprozessor-Aktionen, keine Suchen/Ersetzen-Regeln, keine Shell-Befehle, kein Text/Datei einfügen und keine anderen Conductor-Schritte.

In einer normalen Vorschau können Eigene Regeln das Markdown vor dem Rendern ändern, Stile setzen, CSS oder JavaScript einfügen und mehr. Nichts davon passiert, wenn Sie im Dingus bearbeiten. Ändern Sie Eigene Regeln bei geöffnetem Dingus, aktualisiert das seine Vorschau nicht.

Der Dingus kann dieselben Vorschau-CSS-Stile wie das Hauptfenster verwenden (über das Stilmenü im Ausgabebereich). Das betrifft nur das Aussehen; es ist nicht dasselbe wie das Ausführen Eigener Regeln.

In Dingus öffnen aus einer Vorschau lädt den aktuellen Markdown-Puffer des Dokuments. Sind beim Öffnen dieser Datei in Marked bereits Eigene Regeln gelaufen, sehen Sie deren Auswirkungen womöglich im Text (zum Beispiel von einer Regel eingefügten Text), aber der Dingus wendet die Regeln während der Eingabe nicht erneut an. Um Eigene Regeln zu testen, nutzen Sie eine normale Marked-Vorschau oder speichern Sie aus dem Dingus und öffnen die Datei mit In Marked öffnen.

Was ist ein „Dingus“?

„Dingus“ ist ein aus der Webentwicklung entlehnter Begriff für ein einfaches Testwerkzeug oder eine Sandbox-Umgebung. Mit dem Markdown-Dingus experimentieren Sie mit Markdown-Syntax und sehen sofort, wie verschiedene Prozessoren sie interpretieren.

Zugriff auf den Dingus

Den Markdown-Dingus erreichen Sie über Hilfe Markdown-Dingus öffnen. Besonders nützlich ist er, wenn Sie:

  • neue Markdown-Syntax lernen möchten
  • Rendering-Probleme beheben wollen
  • zwischen verschiedenen Prozessoren den für Ihren Anwendungsfall am besten passenden suchen
  • Dokumentation schreiben, die über mehrere Systeme hinweg funktionieren muss

Drei-Fenster-Layout

Das Dingus-Fenster ist in drei synchronisierte Bereiche unterteilt:

1. Markdown-Eingabe (linker Bereich)

  • Syntaxhervorhebung: Ihr Markdown wird farblich hervorgehoben, damit die Struktur klar wird
  • Live-Bearbeitung: Tippen Sie und sehen Sie Änderungen sofort in den anderen Bereichen
  • Große Schrift: 21-pt-Menlo-Schrift für komfortables Bearbeiten

Options-Dropdown (oben rechts im linken Bereich): Über das Menü Optionen schalten Sie um:

  • Zeilennummern anzeigen: Zeigt am linken Rand eine Spalte mit einer Zeilennummer pro Absatz (umbrochene Zeilen zählen als eine Zeile).
  • Unsichtbare anzeigen: Zeigt Leerzeichen als Mittelpunkte (·), Tabulatoren als Rechtspfeil (→) und Zeilenumbrüche als Zeilenschaltungssymbol (↵) in hellem Grau, damit Sie verirrte Steuerzeichen erkennen.
  • Gremlins hervorheben: Legt einen hellroten Hintergrund auf Nicht-ASCII-Zeichen (z. B. typografische Anführungszeichen, Emoji) und einen dunkelroten Hintergrund auf problematische unsichtbare Zeichen (z. B. Zeichen ohne Breite). Normale Tabulator- und Zeilenumbruchzeichen werden nicht hervorgehoben.

Ihre Auswahl wird gespeichert und beim nächsten Öffnen des Dingus wiederhergestellt.

Suchleiste: Drücken Sie ⌘F, um die Suchleiste unter der Beschriftung „Markdown-Eingabe“ einzublenden. Sie können im Editor suchen und ersetzen, mit ⌘G weitersuchen und mit ⇧⌘G rückwärts suchen sowie eine oder alle Übereinstimmungen ersetzen. Über die Schließen-Schaltfläche oder erneut ⌘F blenden Sie die Suchleiste aus.

2. HTML-Quelltext (mittlerer Bereich)

  • Erzeugtes HTML: Sehen Sie genau, welches HTML der gewählte Prozessor erzeugt
  • Syntaxhervorhebung: Die HTML-Syntax ist zum leichteren Lesen farblich gekennzeichnet

3. Gerenderte Vorschau (rechter Bereich)

  • Live-Vorschau: Sehen Sie, wie Ihr Markdown gerendert aussieht
  • Emoji-Unterstützung: Emojis im GitHub-Stil wie :zzz: werden in Bilder umgewandelt
  • Auto-Scrollen: Scrollt automatisch zu Ihrer aktuellen Bearbeitungsposition

Bearbeiten im Dingus

Der Markdown-Eingabebereich bietet intelligente Bearbeitungsfunktionen, die das Schreiben von Markdown schneller und natürlicher machen.

Intelligenter Zeilenumbruch (Return-Taste)

Ein Druck auf Return passt sich an die aktuelle Zeile an:

  • Listen: In einer Listenzeile (-, *, + oder 1.) fügt er ein neues Listenelement mit der richtigen Markierung ein. Nummerierte Listen laufen mit der nächsten Nummer weiter.
  • Blockzitate: In einer Zeile, die mit > beginnt, fügt er eine neue Blockzitat-Zeile ein.
  • Code-Blöcke: In einer Zeile mit drei oder mehr Backticks (z. B. ```) fügt er eine Leerzeile zwischen öffnendem und schließendem Element ein.
  • Andere Zeilen: Fügt einen normalen Zeilenumbruch ein.

Zeichenpaarung

Wenn Sie ein öffnendes Zeichen tippen, fügt der Editor automatisch das schließende Zeichen ein und setzt den Cursor dazwischen. Unterstützte Paare: " ' ( [ ` <.

  • Mit Auswahl: Umschließt den ausgewählten Text mit dem Paar.
  • Ohne Auswahl: Fügt das Paar ein und setzt den Cursor dazwischen.
  • Type-over: Ist das nächste Zeichen bereits das schließende Trennzeichen, bewegt ein erneutes Tippen den Cursor daran vorbei, statt ein Duplikat einzufügen.
  • Leerzeichen im leeren Paar: Steht der Cursor zwischen einem leeren Paar (z. B. (|)), ersetzt ein Leerzeichen das schließende Zeichen durch ein Leerzeichen.

Tastenkürzel

Kürzel Aktion
⌘F Suchleiste im Markdown-Eingabebereich ein- oder ausblenden
⌘G Weitersuchen (wenn die Suchleiste sichtbar ist)
⇧⌘G Rückwärts suchen (wenn die Suchleiste sichtbar ist)
⌘B Fett: Auswahl in ** umschließen oder **|** mit Cursor dazwischen einfügen
⌘I Kursiv: Auswahl in _ umschließen oder _|_ mit Cursor dazwischen einfügen
⇧⌘L Listenmarkierung durchschalten (ungeordnet ↔ geordnet)
Tab Zeile oder Listenelement einrücken
Umschalt+Tab Zeile oder Listenelement ausrücken
⌃⌘→ Zeile oder Listenelement einrücken (wie Tab)
⌃⌘← Zeile oder Listenelement ausrücken (wie Umschalt+Tab)
⌃⌘↑ Absatz nach oben verschieben (Absatz samt Zeilenumbruch ausschneiden, eine Zeile höher einfügen)
⌃⌘↓ Absatz nach unten verschieben (Absatz samt Zeilenumbruch ausschneiden, eine Zeile tiefer einfügen)
⌘K Markdown-Link einfügen oder umschließen: Auswahl als [text]() umschließen und den Cursor in die URL setzen, oder ohne Auswahl []() mit dem Cursor zwischen den Klammern einfügen
F6 Magischer Referenzlink: Auswahl als [text][n] umschließen und am Dokumentende eine [n]: -Definition anfügen; steht der Cursor auf einer vorhandenen Referenz, zwischen Inline-Marker und Definition springen
F7 Magische Fußnote [^n] an der Cursorposition (oder nach dem aktuellen Wort) einfügen und am Dokumentende eine passende [^n]: -Definition anfügen; steht der Cursor auf einer vorhandenen Fußnote, zwischen Marker und Definition springen
⌘U Ausgabebereich umschalten (Quelltext/Vorschau)
⌥⌘↑ Auswahl erweitern: Wort → innere/äußere Trennzeichen → Satz → Absatz → zusammenhängender Block (z. B. eine Tabelle oder ein Codeblock) → umschließende Liste/Blockzitat/Codeblock → Dokument
⌥⌘↓ Auswahl über dieselben Ebenen zurück bis zur ursprünglichen Cursorposition verkleinern

Tab/Umschalt+Tab (und ⌃⌘←/⌃⌘→) berücksichtigen Listenstruktur und Blockzitate: Sie rücken Listenelemente ein oder aus und fügen > in Blockzitat-Zeilen hinzu oder entfernen es. „Absatz nach oben/unten verschieben“ wählt den gesamten Absatz unter dem Cursor aus (samt nachfolgendem Zeilenumbruch), schneidet ihn aus und fügt ihn über oder unter dem angrenzenden Absatz ein, damit Absätze nicht verschmelzen.

Der Dingus-Editor kann für Sie Referenzlinks und Fußnoten anlegen, vergibt automatisch die nächste freie Nummer und hängt die passende Definition am Dokumentende an.

  • F6 (magischer Referenzlink): Mit markiertem Text wird die Auswahl als [text][n] umschlossen und am Dokumentende eine neue [n]: -Zeile ergänzt, in die Sie die URL eintragen. Zum Anlegen eines neuen Referenzlinks ist eine Auswahl nötig. Steht der Cursor bereits auf einem Referenzlink oder seiner Definition, springt F6 zwischen Inline-Marker und Definition (oder legt die Definition an, falls sie fehlt).
  • F7 (magische Fußnote): Fügt an der Cursorposition – oder nach dem aktuellen Wort, wenn der Cursor darin steht – einen nummerierten Fußnotenmarker [^n] ein und hängt [^n]: an; bei markiertem Text wird der markierte Text als Fußnotentext verwendet. Steht der Cursor auf einem vorhandenen Fußnotenmarker oder einer Definition, springt F7 zwischen beiden.

Referenz- und Fußnotennummern werden automatisch vergeben, sodass Sie keine IDs von Hand verwalten müssen. Beide Tastenkürzel funktionieren nicht in abgegrenzten oder eingerückten Codeblöcken.

Intelligentes URL-Einfügen

Wenn Sie einfügen und die Zwischenablage eine URL der Form protocol://... ohne Leerzeichen enthält:

  • Mit Auswahl: Die Auswahl wird in einen Markdown-Link umgewandelt: [selected text](url).
  • Ohne Auswahl: Die URL wird als Selbstlink eingefügt: <url>.

So verwandeln Sie kopierte URLs bequem in Links, ohne sie von Hand zu tippen.

Intelligente Auswahl (⌥⌘↑ / ⌥⌘↓)

Der Dingus-Editor unterstützt eine semantische Auswahlerweiterung:

  • ⌥⌘↑ beginnt an der Cursorposition und erweitert die Auswahl über:
    • das aktuelle Wort
    • innere und äußere abgegrenzte Inhalte (Anführungszeichen, eckige Klammern, runde Klammern und abgegrenzte Codeblöcke)
    • den aktuellen Satz
    • den aktuellen Absatz
    • den zusammenhängenden, nicht leeren Zeilenblock (zum Beispiel eine ganze Tabelle oder einen mehrzeiligen Codeblock ohne Leerzeilen)
    • das umschließende Listenelement, Blockzitat oder den umschließenden Codeblock
    • das gesamte Dokument
  • ⌥⌘↓ geht dieselben Ebenen wieder zurück, bis die ursprüngliche Cursorposition erreicht ist.

Jeder Druck führt immer zu einer strikt größeren oder kleineren Auswahl, sodass beim Erweitern oder Verkleinern nie ein „No-Op“-Tastendruck entsteht.

Den Dingus als Editor verwenden

Der Dingus soll keinen vollwertigen Texteditor ersetzen, ist aber sehr praktisch für schnelle Bearbeitungen mit Live-Vorschau, besonders wenn Sie genau sehen wollen, wie sich Änderungen rendern. Das gesamte in Bearbeiten im Dingus beschriebene Textbearbeitungsverhalten gilt auch hier.

Eine Datei öffnen / eine neue Datei erstellen

  • Eine neue Datei im Dingus erstellen
    • Wählen Sie Ablage Neu Neue Markdown-Datei (⌘N).
    • Wählen Sie bei der Nachfrage Dingus, um ein neues, ungespeichertes Dingus-Dokument zu beginnen.
    • Neue Dingus-Dokumente öffnen sich mit ausgewähltem Beispielinhalt; tippen Sie einfach los, um ihn zu ersetzen.
  • Eine vorhandene Datei im Dingus öffnen
    • Verwenden Sie Ablage In Dingus öffnen… (⌥⌘O), oder klicken Sie bei aktivem Dingus-Fenster in der Statusleiste auf Öffnen…. Der Befehl öffnet bei Bedarf das Dingus-Fenster und zeigt dann das Öffnen-Fenster.
    • Wählen Sie eine beliebige unterstützte Klartext-/Markdown-Datei; ihr Inhalt ersetzt den aktuellen Dingus-Puffer.
  • Ein Marked-Vorschaudokument im Dingus öffnen
    • Verwenden Sie in einem normalen Vorschaufenster Vorschau In Dingus öffnen (⌥⌘E).
    • Das Markdown des aktuellen Dokuments wird in den Dingus geladen, sodass Sie experimentieren können, ohne die Originaldatei anzutasten, bis Sie speichern. Eigene Regeln werden im Dingus nicht angewendet; siehe Eigene Regeln gelten nicht.

Eine Datei speichern

  • Änderungen an der aktuellen Datei speichern
    • Klicken Sie im Dingus-Fenster in der Statusleiste auf Speichern oder verwenden Sie Ablage Dingus speichern (⌘S).
    • Wurde das Dingus-Dokument noch nicht gespeichert, werden Sie nach Speicherort und Dateinamen gefragt; danach aktualisiert ⌘S dieselbe Datei.
  • Speichern unter / in eine neue Datei duplizieren
    • Verwenden Sie Ablage Dingus speichern unter… (⌥⌘S).
    • Das öffnet immer einen Speichern unter-Dialog und schreibt den aktuellen Dingus-Inhalt in eine neue Datei, ohne das Original zu überschreiben.

In Marked ansehen

  • Das Dingus-Dokument als vollständige Marked-Vorschau öffnen
    • Klicken Sie in der Dingus-Statusleiste auf In Marked öffnen oder verwenden Sie Ablage Dingus in Marked öffnen (⌘P).
    • Ist das Dingus-Dokument ungespeichert oder hat es ungespeicherte Änderungen, werden Sie zuerst zum Speichern aufgefordert; dann öffnet Marked eine normale Vorschau für diese Datei.

Mit diesen Befehlen nutzen Sie den Dingus als leichten Editor für schnelle Korrekturen und Experimente und springen dann zu einer vollständigen Marked-Vorschau oder Ihrem gewohnten Editor, wenn Sie umfangreicher bearbeiten wollen.

Prozessorauswahl

Verwenden Sie das Dropdown-Menü oben, um zwischen verschiedenen Markdown-Prozessoren zu wechseln:

  • MultiMarkdown: Voll ausgestatteter Prozessor mit Tabellen, Fußnoten und Mathematik-Unterstützung
  • CommonMark (GFM): Standardkonformer, schneller Prozessor nach der CommonMark-Spezifikation
  • Discount: GitHub Flavored Markdown mit Aufgabenlisten und Tabellen
  • Kramdown: Fortgeschrittener Prozessor mit Zusatzfunktionen wie IALs und Typografie

Warum den Dingus verwenden?

Prozessorunterschiede verstehen

Verschiedene Markdown-Prozessoren behandeln Syntax unterschiedlich. Mit dem Dingus können Sie:

  • Ausgabe vergleichen: Sehen Sie genau, wie jeder Prozessor dasselbe Markdown rendert
  • Probleme debuggen: Erkennen Sie, warum eine bestimmte Syntax nicht wie erwartet funktioniert
  • Syntax lernen: Verstehen Sie die feinen Unterschiede zwischen den Prozessor-Implementierungen

Vor dem Schreiben testen

Bevor Sie sich in Ihren Dokumenten auf einen bestimmten Markdown-Stil festlegen:

  • Syntax prüfen: Stellen Sie sicher, dass Ihr Markdown korrekt rendert
  • Prozessoren wählen: Entscheiden Sie, welcher Prozessor am besten zu Ihrem Inhalt passt
  • Sicher experimentieren: Probieren Sie neue Syntax aus, ohne Ihre echten Dokumente zu beeinflussen

Häufige Anwendungsfälle

Unterschiede in der Tabellensyntax

Manche Prozessoren behandeln Tabellensyntax unterschiedlich. Der Dingus zeigt Ihnen, welcher Prozessor Ihre Tabellenformatierung am besten unterstützt.

Fußnoten-Unterstützung

Nicht alle Prozessoren unterstützen Fußnoten. Prüfen Sie mit dem Dingus, ob die Fußnotensyntax mit Ihrem gewählten Prozessor funktioniert.

Mathematik und Sonderzeichen

Testen Sie, wie verschiedene Prozessoren mathematische Ausdrücke und besondere Typografie-Zeichen behandeln.

Tipps für den effektiven Einsatz

  1. Einfach anfangen: Beginnen Sie mit einfachem Markdown und steigern Sie die Komplexität schrittweise.
  2. Grenzfälle testen: Probieren Sie ungewöhnliche Syntax-Kombinationen, um die Grenzen der Prozessoren auszuloten.
  3. Nebeneinander vergleichen: Wechseln Sie zwischen Prozessoren, um Unterschiede klar zu erkennen.
  4. Echte Inhalte verwenden: Kopieren Sie tatsächliche Inhalte aus Ihren Dokumenten, um realistische Szenarien zu testen.

Der Dingus ist ein mächtiges Werkzeug für alle, die die Feinheiten verschiedener Markdown-Implementierungen verstehen und sicherstellen wollen, dass ihre Inhalte über verschiedene Plattformen und Prozessoren hinweg korrekt rendern.

Next up: MultiMarkdown-v5-Spezifikation ▶

Support Site | Legal | Privacy